home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr38 / tland110.zip / TL.DOC < prev    next >
Text File  |  1995-03-18  |  8KB  |  234 lines
  1.                                  Trivia Land
  2.                               
  3.                                 Version 1.10
  4.  
  5.                         Copyright 1995, Jeffrey Baker
  6.  
  7.                                 Documentation
  8.        
  9.        Description
  10.        -----------
  11.  
  12.        Trivia Land is basically a conference room, where user's of 
  13.        your BBS can go in and chat with each other.  The difference
  14.        is that there is some strange guy in there named "Trivia Man"
  15.        who asks all these questions to the users.  If a user answers
  16.        one of the trivia questions correctly then he gets to select
  17.        the topic for the next question.  Trivia Man keeps track of 
  18.        how many questions each user has answered correctly.
  19.  
  20.        You, as the SYSOP (System Operator) of your BBS can make up
  21.        your own trivia questions and answers or add to the ones 
  22.        already there.  Or you could get a friend or one of your
  23.        user's to make some up.  See "Editing Data Files" for more
  24.        detail.
  25.  
  26.        Features:
  27.        
  28.        Trivia Land offers 16550 UART support, FOSSIL support, 
  29.        Digiboard support, multi-node support, multi-BBS support,
  30.        Desqview aware, local sysop function keys, and more.
  31.  
  32.    
  33.        PCBoard   is a registered trademark of Clark Development Company.
  34.  
  35.        WILDCAT!  is a registered trademark of Mustang Software.
  36.  
  37.        SPITFIRE  is a registered trademark of Buffalo Creek Software
  38.  
  39.        RBBS-PC   is copyright (c) Tom Mack,  Capital PC Software Exchange
  40.  
  41.        QUICKBBS  is copyright (c) Adam Hudson
  42.  
  43.        REMOTE ACCESS is copyright (c) Andrew Milner, Continental Software
  44.  
  45.        MBBS is copyright (c) Mike Anderson
  46.  
  47.        DigiBoard is copyright (c) DigiBoard,  Eden Prarie, MN
  48.  
  49.  
  50. Running Trivia Land
  51. -------------------
  52.  
  53.        Trivia Land is ran as follows:  
  54.  
  55.  
  56. TRIVIA path\door.inf PORT:xxxx:xx
  57.  
  58.        Here are a few examples:
  59.  
  60. TRIVIA  C:\PCB\DOOR.SYS                  ;Using standard ports
  61. TRIVIA  C:\WC\CALLINFO.BBS PORT:03E8:12  ;Using non-standard port and irq 12
  62. TRIVIA  C:\PCB\PCBOARD.SYS PORT:F:1      ;Using a fossil driver on port 1
  63. TRIVIA  config.cfg PORT:D:5              ;Using Digiboard channel 5
  64.  
  65.  
  66.  
  67. If you need to specify a non-standard port address and IRQ, then the 
  68. syntax is PORT:xxxx:xx where xxxx is the base address (hex) and xx is 
  69. the IRQ (0-15 decimal). 
  70.  
  71. PORT is optional, and Trivia Land will default to standard addresses 
  72. and irq's if PORT is not used based on the port number read from the 
  73. BBS file.  Trivia Land will assume COM1 = 03F8 IRQ 4, COM2 = 02E8 IRQ3, 
  74. COM3 = 03E8 IRQ4 and COM4 = 02E8 IRQ 3.  If the sysop had a different 
  75. non-standard port address and irq, he could then use the PORT command.
  76.  
  77. The Sysop can use the following commands while a user is in 
  78. Trivia Land:
  79.  
  80.              Function key
  81.              ------------
  82.                 F5              Shell to DOS
  83.                 F8              Return user to system
  84.                 F9              Toggle display on/off
  85.                 F10             Chat mode  (use the ESCAPE key to exit)
  86.  
  87.              Alternate key
  88.              -------------
  89.                ALT-H            Toggle between different status lines
  90.  
  91.         Alternately pressing the ALT-H key will bring up
  92.         the next status line screen.  The 1st screen is a help screen,
  93.         the second second screen shows your COM port status.
  94.  
  95. GENERIC.SYS
  96. -----------                         
  97.  
  98.    For maximum compatibility, Trivia Land will also read a file called
  99. GENERIC.SYS.  This file can be created by the sysop desiring to run
  100. the door and allow Trivia Land to operate.  This would allow this door to
  101. operate on ANY BBS system.  The GENERIC.SYS file is a standard ASCII file 
  102. and contains 3 lines, each followed by a carriage return, line feed.  
  103. The format is:
  104.  
  105.         line 1  -  The BBS operator's name.
  106.         line 2  -  The COM port in use.
  107.         line 3  -  Time allowed in door.
  108.  
  109. Below is an example GENERIC.SYS file with a sysop name of Rickie,
  110. using Com port 1, and allowing 50 minutes in the door.
  111.  
  112. Rickie
  113. COM1:
  114. 50
  115.  
  116.   Each line is followed by a C/R, L/F and the com port follows the same
  117. format as the standard door.sys.  COM0: = Local Mode (same as door.sys)
  118. See the compatibilty issues below for more information.
  119.  
  120. Editing Data Files
  121. ------------------
  122.  
  123. TRIVIA.DAT
  124.  
  125. Trivia Land contains a data file called TRIVIA.DAT.  This file looks
  126. similiar to this:
  127.  
  128. Music
  129. music.trv 1
  130. Computer Related
  131. computer.trv 4
  132.  
  133. "Music" and "Computer Related" are both topics that are shown in Trivia
  134. Land.  You can have up to eight topics in TRIVIA.DAT.  Under each
  135. topic description is the name of the file that contains the questions
  136. and answers for that topic.  "music.trv" is the file for "MUSIC".
  137. The number after the filename is the current question number.
  138.  
  139. So add more topics to TRIVIA.DAT if you desire.  But remember that only
  140. eight topics can be available.
  141.  
  142. MUSIC.TRV
  143.  
  144. Now for the trivia data files themselves.  The data files written as
  145. follows:
  146.  
  147. Q#1
  148. "Only the Lonely, "Blue Angel" and "Crying" are among whose hits?
  149. A#1
  150. Roy Orbison
  151. A#1
  152. Roy
  153. A#1
  154. Orbison
  155. Q#2
  156. From what musical is "I've Gotta Crow"?
  157. A#2
  158. Peter Pan
  159.  
  160. Lets take a look at this file.  First of all each question is preceeded
  161. by Q#x .  Where x is the question number for that question.  Then the
  162. question.  It can be up to two lines long.  Then on the next line is A#x .
  163. If the question was number 1.  Then the answer would be A#1.  You
  164. can have up to five answers for each question.  The first answer after
  165. each question should be the complete answer.  The other answers for
  166. each question can be partial but acceptable answers the contestants may
  167. give. 
  168.  
  169. If you notice, each trivia question file contains E# on the last line.
  170. Remember to put that on the very last line of each question file.
  171.  
  172. So edit the trivia data files already available or create your own by
  173. following the above guidelines.  Have fun.
  174.  
  175. READ THE FOLLOWING!!!!
  176. ----------------------
  177.  
  178. One more last thing.  
  179. If your BBS crashes, the power goes out, your computer is unplugged,
  180. or turned off while Trivia Land is being used, Trivia Land will
  181. not be able to perform some cleanup functions.  When ran again
  182. Trivia Land will think that all the users that were on when the
  183. program was aborted as stated above, are still on.  To solve this
  184. problem you need to erase the file WHO.DAT and all the .USR files.
  185.  
  186. A quicker way to  solve this problem would be to make a temporary
  187. directory for these files.  Then make a file called DIR.DAT in the 
  188. directory containing TRIVIA.EXE.
  189.  
  190. DIR.DAT can look like this:
  191.  
  192. C:\TTEMP\
  193.  
  194. TTEMP is the temporary directory you should have made.
  195. Then if Trivia Land is stopped without being able to perform its 
  196. cleanup functions, all you have to do is erase all the files in
  197. the temporary directory.
  198.  
  199. There is another reason for using a temporary directory.  The
  200. reason is:  More speed.  Trivia Land uses alot of disk access for
  201. its data files.  You could make a temporary directory on a RAM
  202. drive.  Then specify this directory in DIR.DAT.  All writing of
  203. files will then be done on the RAM drive (memory), instead of on
  204. a slow hard drive.
  205.  
  206. Thats it for now.
  207.  
  208. SHAREWARE
  209. ---------
  210.  
  211. Trivia Land is shareware.  Please feel free to distibute this 
  212. version to others as long as all the files including this
  213. documentation are distributed together unmodified.  
  214.  
  215. If you like Trivia Land are using on your BBS, please send
  216. a check or money order for $25 made out to "Jeffrey Baker".
  217. Send to the following address:
  218.  
  219. Jeffrey Baker
  220. 242 Melody Lane
  221. Watsonville, CA 95076
  222.  
  223. You will then recieve on floppy diskette a registered version
  224. of Trivia Land, and a program that will allow you to register
  225. all versions of Trivia Land that come out later.  Please specify
  226. 3 1/2 or 5 1/4.  To make this easier print the file ORDER.FRM
  227. and fill it out.
  228.  
  229. To contact me send e-mail to:  jeff.baker@primec.com
  230.  
  231. or send e-mail to Jeff Baker on the BBS at this number:
  232. (408) 724-0599
  233.  
  234.